date_create_immutable_from_format 函数

适用 PHP 版本: PHP 5.5.0 及以上

函数说明

date_create_immutable_from_format 函数根据指定的格式字符串创建一个不可变的 DateTimeImmutable 对象。

函数语法

date_create_immutable_from_format(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTimeImmutable|false

参数

• format (string): 必需。一个日期和时间的格式，使用与 date() 函数相同的格式字符。
• datetime (string): 必需。一个符合指定格式的日期和时间字符串。
• timezone (?DateTimeZone): 可选。用于指定时区。如果未提供，则使用默认时区。

返回值

返回一个 DateTimeImmutable 对象，如果解析失败则返回 false。

示例

以下是一个使用 date_create_immutable_from_format 函数的示例：

$date = date_create_immutable_from_format('Y-m-d H:i:s', '2025-07-11 10:30:00');
if ($date !== false) {
    echo $date->format('Y-m-d H:i:s');
} else {
    echo "日期时间解析失败";
}

示例代码的说明

在上述示例中，调用 date_create_immutable_from_format 函数来创建一个不可变的 DateTimeImmutable 对象。格式字符串 'Y-m-d H:i:s' 被用于解析日期时间字符串 '2025-07-11 10:30:00'。如果解析成功，将返回一个 DateTimeImmutable 对象，并使用 format() 方法输出指定格式的日期时间字符串。如果解析失败，则返回 false，并输出错误消息。